home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (4th Edition) / The Business Master - 4th Edition.iso / files / utilfile / deletes / rdel.txt < prev    next >
Encoding:
Text File  |  1994-02-09  |  12.1 KB  |  256 lines

  1.                               RDEL
  2.                                 
  3.                     Recursive DELete Utility
  4.  
  5.                                By
  6.  
  7.                         Joseph M. Morgan
  8.                               RDEL
  9.                         Table of Contents
  10.  
  11. Copyright and User Information . . . . . . . . . . . . . . . .  1
  12.  
  13. Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  14.  
  15. RDEL - Recursive DELete Utility. . . . . . . . . . . . . . . .  3
  16.      Purpose . . . . . . . . . . . . . . . . . . . . . . . . .  3
  17.      Requirements. . . . . . . . . . . . . . . . . . . . . . .  3
  18.      RDEL - How To Do It . . . . . . . . . . . . . . . . . . .  3
  19.           /s . . . . . . . . . . . . . . . . . . . . . . . . .  3
  20.           /x . . . . . . . . . . . . . . . . . . . . . . . . .  4
  21.           /v . . . . . . . . . . . . . . . . . . . . . . . . .  4
  22.      What RDEL Does. . . . . . . . . . . . . . . . . . . . . .  4
  23.  
  24. Other Information. . . . . . . . . . . . . . . . . . . . . . .  4
  25.      Installing. . . . . . . . . . . . . . . . . . . . . . . .  4
  26.      History & Direction . . . . . . . . . . . . . . . . . . .  4
  27.      Future Support. . . . . . . . . . . . . . . . . . . . . .  5
  28.      Cost & Registration . . . . . . . . . . . . . . . . . . .  5
  29.                  Copyright and User Information
  30.  
  31.      These programs and this documentation is the property of
  32. Joseph M. Morgan.  You may freely copy and distribute this software
  33. and its documentation for non-commercial and non-governmental use
  34. as long as for any given program, the program and it's
  35. documentation are copied and distributed together.  You may not
  36. distribute the software without the documentation or the
  37. documentation without the software.
  38.      Please send all suggestions, inquiries, and other
  39. correspondence to:
  40.  
  41.                     Joseph M. Morgan
  42.                     9045 Kingston Rd. #1804
  43.                     Shreveport, LA 71118
  44.                            Disclaimer
  45.  
  46.      These utilities, their associated documentation and the media
  47. on which they are distributed are distributed as is, with no
  48. warranty either explicit or implied.  Even though every attempt has
  49. been made to provide high-quality, accurate information, this
  50. documentation may contain omissions or errors.  There is no
  51. guarantee, either explicit or implied, that this program will work
  52. properly on any given computer.
  53.      In no event shall Joseph M. Morgan be held liable in any way
  54. for any damages of any kind to include lost profits of any amount,
  55. lost savings of any amount, or other incidental or consequential
  56. damages of any kind arising, for any reason, from the use, misuse,
  57. or inability to use these utility programs and/or their associated
  58. documentation even if Joseph M. Morgan has been advised of the
  59. possibility or occurrence of such damages.
  60.      If the program is defective in any way, you, the user, assume
  61. all responsibility and costs of all necessary repairs and/or
  62. adjustments and/or servicing of any kind.  The distribution rights
  63. and, if applicable, registration cost are all subject to change or
  64. withdrawal without prior notification of any kind.  The contents of
  65. the program documentation may be in error or inaccurate and,
  66. therefore, is subject to change at all times without prior
  67. notification of any kind.
  68.      If you, the user, reside in an area where local laws of any
  69. kind including city, county or parish, state or other local laws
  70. that either explicitly or implicitly require Joseph M. Morgan to
  71. bear responsibility or liability of any kind resulting from the
  72. use, misuse, or inability to use these programs and their
  73. associated documentation, you, the user, are hereby not allowed to
  74. use these programs or their associated documentation, or any other
  75. program and/or its associated documentation produced by Joseph M.
  76. Morgan for any reason or purpose on any computer or equipment
  77. either owned or not owned by you, the user.
  78.      Use of any one of these programs constitutes full agreement
  79. with the conditions of this disclaimer by you, the user, and you
  80. hereby accept all responsibility for use of these programs and
  81. their associated documentation.
  82.                  RDEL - Recursive DELete Utility
  83.  
  84.      Purpose
  85.  
  86.      Did you ever want to delete every file with the .BAK extension
  87. on your hard drive, no matter where it was?  Imagine the time you'd
  88. waste searching and deleting each one.  Even if you use a file
  89. finder and searched for *.BAK, how long would it take you to get
  90. into each directory and delete them?  And if you use a file
  91. manager, again, even with the file specification set to *.BAK, to
  92. mark and delete every *.BAK would take some time.
  93.      RDEL to the rescue!  RDEL is short for Recursive DELete
  94. utility.  What this means to non-computer types is that RDEL
  95. searches from the current working directory, or the directory you
  96. specify, through every sub-directory looking for and deleting every
  97. file matching the file specification you give it.
  98.      RDEL can even find and delete read-only, system, and hidden
  99. files, even if they are in hidden sub-directories!
  100.  
  101.      Requirements
  102.  
  103.      RDEL requires DOS 2.11 or higher to work.  RDEL doesn't check
  104. the version, and I don't know if it will work on a version earlier
  105. than that, but I trust my compiler's technical documentation, and
  106. I couldn't find a computer running anything less than 2.11 on which
  107. to test it!
  108.      If you're using some version earlier than that, try it.  If it
  109. works, the first thing to do is to let me know.  At the very least,
  110. I can correct my documentation.  The next thing you need to do if
  111. you're using a DOS version less than 2.11 is to UPGRADE!!!
  112.  
  113.      RDEL - How To Do It
  114.  
  115.      With all utilities I write, you get help by entering the
  116. program with no arguments on the command line.  What you see is a
  117. Reader's Digest version of this documentation.
  118.      RDEL requires at least two command line arguments:
  119.  
  120.      rdel [/s /x /v] filespec
  121.  
  122. The "filespec" is any valid DOS file specification.  Note that RDEL
  123. will delete every file that matches that file specification in the
  124. current working directory and every sub-directory below it.
  125.      The optional switches are described as follows:
  126.  
  127.      /s
  128.  
  129.      This switch tells RDEL to remove all empty sub-directories
  130. within the tree as it works.
  131.  
  132.      /x
  133.  
  134.      This switch tells RDEL to look for read-only, hidden and
  135. system files.  Be careful using this switch as no file meeting the
  136. specification is safe from RDEL.  RDEL nails 'em!
  137.  
  138.      /v
  139.  
  140.      This turns OFF a verify flag.  Normally, RDEL does it's work
  141. safely, politely asking permission prior to deleting anything. 
  142. But, there is an option to turn OFF that flag causing RDEL to go on
  143. killing everything is sight that matches the file specification.
  144.      Note that even if you turn OFF the verify flag, RDEL will
  145. ALWAYS ask permission before deleting read-only, system, and hidden
  146. files.
  147.  
  148.      What RDEL Does
  149.  
  150.      RDEL takes off by first testing your command line.  If you
  151. have turned OFF the verify flag, RDEL ensures that you didn't make
  152. a mistake, giving you the opportunity to turn the verify flag ON
  153. before going on.
  154.      After that first question, RDEL begins in your current
  155. directory looking for all files matching the file specification. 
  156. It then goes through each sub-directory and each sub-directory
  157. under those looking for files.  As RDEL works, it tells you what it
  158. is doing, telling you that such-and-such file was deleted or this-
  159. and-that sub-directory was removed.
  160.      If the /x switch was used, if a file matching the file
  161. specification that is read-only and or hidden and or a system file,
  162. RDEL will display all the attributes for that file and request
  163. permission before deleting them.
  164.  
  165.                         Other Information
  166.  
  167.      Installing
  168.  
  169.      When you get this program, there is no installation utility. 
  170. In fact, RDEL is ready to run (unless, of course, you haven't un-
  171. archived it from the BBS or service from which you downloaded it). 
  172. Just copy RDEL into a directory that your PATH command includes. 
  173. Look in your DOS manual(s) for more information on what PATH does.
  174.  
  175.      History & Direction
  176.  
  177.      Like all other utilities I write, I first wrote RDEL because
  178. we needed something like it where I work.  I was first asked to
  179. write something that would kill all backup files on a network.  The
  180. backup files numbered in the hundreds, took up mega-mega-bytes, and
  181. were contained in just about every directory on the machine.
  182.      So, I recognize a chance to do something useful and new, so I
  183. wrote something.  We had an old utility that would kill sub-
  184. directories, but it wouldn't delete JUST the backup files.  As I
  185. wrote it, I realized that if I could remove empty sub-directories,
  186. I could also provide a means to remove an entire directory tree.
  187.      If you give the command:
  188.  
  189.      rdel /s /v /x *.*
  190.  
  191. You can guarantee that everything from your current working
  192. directory down will be gone!  Therefore, if you have two versions
  193. of software residing on the same computer, like we often do, and
  194. you need to get rid of the older version with one command, RDEL
  195. will zap it for you.
  196.      I'm sure we aren't the only people seeking a quick and
  197. efficient way to take care of business.  Don't get me wrong.  If I
  198. need to delete one file or all of a particular file specification,
  199. I still use the trusty old DEL command.  And, there are times when
  200. figuring out my exceptions takes longer than using a file manager. 
  201. RDEL isn't intended to replace all these goodies.  It's just more
  202. candy on the cake!
  203.      For future versions, I am planning to provide multiple file
  204. specifications and an exception handler.  If you want an exception
  205. handling delete utility, look for my program XDEL.EXE roaming
  206. around somewhere.  The next version of RDEL, however, will combine
  207. the talents of these two programs into one!
  208.      Any other suggestions are welcome.  Just mail me a note with
  209. the address above or below, and I'll see what I can do.
  210.      
  211.      Future Support
  212.  
  213.      Future support of enhancement requests for RDEL will depend
  214. upon the number of people who respond to me regarding their use of
  215. this program.  YOU DO NOT HAVE TO REGISTER OR PAY ME A DIME TO USE
  216. THIS SOFTWARE (Of course, if you feel generous ...).  But, please,
  217. let me know how you are using the software, what you'd like to see
  218. it do, etc., etc.  You can write to me at the address above or
  219. below.
  220.      Basically, the more people who actually use it, the more
  221. demand I will see, and I will continue to support it.  If enough
  222. people think my stuff is useable, I might just go ahead and shrink-
  223. wrap it!  But, for right now, I want to be able to deliver the kind
  224. of stuff we have found we have needed to the rest of the world.
  225.  
  226.      Cost & Registration
  227.  
  228.      There is no cost or registration for RDEL.  I am distributing
  229. the program and this documentation as FREEWARE!!!
  230.      Now, THIS is how I want to make my money.  I will sell the
  231. COMPLETE C SOURCE CODE for RDEL for $10.00.  Just send a request
  232. and $10.00 to me at:
  233.  
  234.                Joseph M. Morgan
  235.                9045 Kingston Rd. #1804
  236.                Shreveport, LA 71118
  237.  
  238.      Checks and cash and things that can be turned into cash will
  239. be accepted.  No credit cards please.  (Of course, if you'd like to
  240. send my kids to college or buy me a new house, I'll accept that
  241. too!)
  242.      Be sure to include your return address and the kind of
  243. diskettes you want.  I will send it the day I receive payment.  You
  244. will receive a package with the latest executable version of RDEL,
  245. the latest C source code both printed AND on the diskette type and
  246. size you request.
  247.      I'll hang on to your address so that if we discover a small
  248. bug or some other kind of cosmetic problem, I'll send you the
  249. corrected source FREE, up to but not including the next major
  250. version of RDEL!  (Sounds like registration, doesn't it???)
  251.      I'll probably even be nice enough to give you the next
  252. version's source for half-price or something if you order.<g> 
  253. Whatever the case, I won't let you regret it.  I'm not doing this
  254. to get rich, I just think that the program doesn't offer enough for
  255. sale, but the source does!
  256.